⚠️ BREAKING CHANGE

This PR introduces a breaking change that requires the region parameter when using the Terminal Cloud API.

Summary

• Add mandatory region validation for TerminalCloudAPI initialization
• Throw a clear error message when region is not specified
• Update all tests to include region parameter
• Add new test cases to verify region validation behavior

Why this change?

The Terminal Cloud API endpoints are region-specific, and the library already supports multiple regions (EU, AU, US, APSE). However, the region parameter was optional, which could lead to:

• Runtime errors when the wrong endpoint is used
• Confusion about which endpoint is being called
• Potential issues with region-specific features

Making the region parameter mandatory at initialization time provides:

• ✅ Clear error messages at construction time (fail-fast)
• ✅ Explicit regional endpoint configuration
• ✅ Better developer experience with early validation

Breaking Change Details

Before (v30.0.0)

const client = new Client({
  apiKey: "YOUR_API_KEY",
  environment: EnvironmentEnum.TEST
});

const terminalAPI = new TerminalCloudAPI(client); // This was allowed

After (this PR)

import { RegionEnum } from '@adyen/api-library';

const client = new Client({
  apiKey: "YOUR_API_KEY",
  environment: EnvironmentEnum.TEST,
  region: RegionEnum.EU  // ⚠️ Now required for Terminal API
});

const terminalAPI = new TerminalCloudAPI(client); // ✅ Works